Text Library Objects
Function / Event |
Return Value |
Description |
Syntax |
Text |
|||
Compare two Strings Ignoring Case |
Boolean |
Compares two given text values. While comparing, this operation ignores the case of the text. |
Compare <string1> with <string2> case independently |
Concatenate |
Text |
Concatenates the specified texts. |
Concatenate <List Of Text > |
Convert To Lower Case |
Text |
Converts all uppercase letters in a specified text to lower case. |
Convert <Text> To Lower Case |
Convert To Upper Case |
Text |
Converts all lowercase letters in a specified text to upper case. |
Convert <Text> To Upper Case |
Extract Prefix Subtext Which Excludes Character Set |
Text |
Extracts the left-most sequence of the text that does not contain characters from a given set; extraction ceases when a character that is included in the set is found. |
Extract Prefix Subtext Of <Text> Which Excludes <Character Set> |
Extract Prefix Subtext Which Includes Character Set |
Text |
Extracts the left-most sequence of the text that contains characters from a given set; extraction ceases when a character that is not included in the set is found. |
Extract Prefix Subtext Of <Text> Which Includes <Character Set> |
Extract Subtext |
Text |
Extracts a subtext of a specified length from the source text, starting at the specified position (1-based). |
Extract Subtext Of <Length In Characters> From <Source Text> Starting At <Start Position> |
Find Char Position |
Number |
Finds the first position (1-based) of any of the characters in a set in a specified text. |
Find Any Character From <Character Set> in <Text> |
Find Subtext Position |
Number |
Finds the start index (1-based) of a subtext in a text. |
Find <Subtext> Position In <Text> Starting At <Start Position> |
Find Subtext Using Wildcard |
Number |
Finds the position of a subtext in a text. Wildcard characters (any number of ? or a single *) can be used in the same manner of the LIKE operator of SQL. |
Find <Subtext> In <Text> Using Wildcard Characters |
Insert Subtext |
Text |
Inserts a subtext into a text, according to a specified subtext and location. |
Insert Subtext <Text To Insert> Into <Target Text> At <Insert Position> |
Is Empty Or Has Spaces |
Boolean |
Checks whether the given text is empty or contains only spaces. |
Check if <inputString> is empty or contains only spaces |
Length Of Text |
Number |
Counts the characters in a text. |
Length Of <Text> |
Logical to Visual |
Text |
Converts a string from logical to visual. This is used for international text such as Hebrew. For more information, see Visual vs. logical ordering of text. (This link was active at the time of this publication. It is not maintained by NICE.) |
<Text> |
Pad Text |
Text |
Concatenates a text with another text according to a specified number of repetitions and a specified length. |
Pad <Text> From <Left To Right> Up To <Length> With <Text To Repeat> |
Remove Spaces From String |
Text |
Removes all occurrences of white spaces from the specified text. |
Remove all occurrences of white space characters from <inputString> |
Repeat Text |
Text |
Concatenates a given number of text repetitions. |
Repeat <Text> <Number Of Repetitions> Times |
Replace Subtext |
Text |
Replaces a character or subtext with another in the specified text. |
Replace <Subtext> In <Text> By <Alternative Text> <Number Of Replacements> |
Reverse Extract Subtext |
Text |
Extracts a subtext of a specified length from the source text, starting at the end of the source text. |
Reverse Extract Subtext of <Length In Characters> From <Source Text> |
Reverse Find Subtext |
Number |
Finds the start index (1-based) of a subtext in a text starting at the end of the text. |
Reverse Find <Subtext> Position In <Text> |
Reverse The Order Of Characters |
Text |
Reverses the order of the characters in the text. |
Reverse The Order Of Characters In <Text> |
Split |
List of text |
Splits the text by a delimiter and outputs the result as a text list. |
Split <Text> By <Delimiter> Into A Text List |
Split by delimiters |
List of text |
Splits the text by one or more delimiters and outputs the result as a text list. |
Split <text> by one or more delimiters <Add delimiter> into a list of text |
Substring from Left of the String |
Text |
Extracts a substring with the specified length from the left of the source text. Returns the extracted text. For example, you specify the length as 5, and the source text as Hello World. The function will return Hello as the extracted text. |
Extract subtext from left of <inputString> of length <number> |
Substring from Right of the String |
Text |
Extracts a substring with the specified length from the left of the source text. Returns the extracted text. For example, you specify the length as 5, and the source text as Hello World. The function will return World as the extracted text. |
Extract subtext from right of <inputString> of length <number> |
Trim |
Text |
Removes all occurrences of white space characters from the beginning and end of the specified text. |
Trim <Text> |
Trim End |
Text |
Removes all occurrences of white space characters from the end of the specified text. |
Trim End <Text> |
Trim Start |
Text |
Removes all occurrences of white space characters from the beginning of the specified text. |
Trim Start <Text> |
Wild Compare |
Boolean |
Compares the specified text to the specified pattern using case-sensitive criteria according to specification (wild cards are * and ?). |
Wild Compare <Text> To <Pattern> Using <Case Sensitive> |